Introduction
Learn about the conceptual aspects of Cumulocity IoT Edge, the single-server variant of the Cumulocity IoT platform.
Overview
Edge is delivered as a software appliance designed to run on industrial PC’s or local servers.
In contrast to Cumulocity IoT platform, which is available in the cloud (for example, using AWS, Azure or other data centers), Edge is installed in factories, that is, in the same site (“onsite”) in which the IoT assets are located.
Reasons for using an onsite installation of Edge include:
- Autonomy: Even if there is no cloud connection, tasks like data collection and data analysis can still be performed.
- Data reduction: Data is analyzed and aggregated close to assets, and thus less data needs to be sent to the cloud.
- Reactivity: Both Edge and Cumulocity IoT platform include real-time streaming analytics engines. However, placing the rule execution in Edge reduces latency, because the round-trip to cloud is omitted.
Features of Edge include:
- Edge Agent, which enables remote monitoring and management of an Edge instance from the Cumulocity IoT tenant.
- Data Broker to send IoT data to the cloud and receive operations from the cloud, with web-based UI to filter data.
- Streaming Analytics engine for real-time local data analysis including the Cumulocity IoT Analytics Builder.
- Ready-to-use Cockpit and Device Management applications.
- Native protocol support for MQTT and REST.
- Edge database for operational data storage.
- OPC UA with web-based UI for efficient connection management and seamless integration of industrial automation systems.
- Easy installation, upgrades and backup/restore.
- Microservice hosting, which allows to run server-side applications which may be used to extend the Cumulocity IoT platform with customer-specific functionality (optional component).
- DataHub Edge for historical data storage and analytics (optional component).
Versions
Cumulocity IoT Edge 10.18 uses the following versions:
Edge component |
Version |
|---|---|
| Cumulocity IoT platform | 10.18.0 |
| Streaming Analytics | 10.18 |
Cumulocity IoT Edge versus other Cumulocity IoT deployments
Edge uses the same software as Cumulocity IoT platform.
However, while the base software is the same, there are differences regarding the activated optional features and pre-installed agents.
The following differences apply:
Area |
Edge | Cumulocity IoT platform |
|---|---|---|
| Multi-tenancy | No; single tenant | Yes |
| Cluster | No; single server | Yes |
| High availability | HA capabilities depend on the underlying virtualization technology, server failure could lead to temporary downtime* | Full HA: No downtime on server failure, optionally even for data center failure |
| Vertical scalability | Yes, limited to appr. 100 tps per CPU core | Yes, but not used |
| Horizontal scalability | No | Yes, nearly unlimited scalability |
| Upgrades with no downtime | No | Yes |
| Root access | Yes | Yes, if customer is hosting |
| Installation | Offline, with VM image | Online |
| Cloud Field Bus | Included | Optional |
| Streaming Analytics | Included | Optional |
| Data Broker | Included | Optional |
| OPC UA | Included | Optional |
| Microservice Hosting | Optional | Optional |
| Machine Learning | Optional | Optional |
| Data Hub | Optional | Optional |
Footnote: * The underlying infrastructure including the virtualization is not part of the product. For further details on high availability or fault tolerance options, refer to the relevant information provided by third parties (for example, vSphere Availability).
In addition to Edge, we provide a light-weight approach to implement Edge functionality: the open-source Cumulocity IoT Device SDKs. These can be utilized to build agents on less powerful devices like embedded devices.
Edge functionalities
Since Edge is based on the same software as the cloud-based Cumulocity IoT platform version, the included applications are the same in both versions, with minor restrictions.
For general information about functionalities and features of Cumulocity IoT platform, see Get familiar with the UI.
Below you can find the links to the most common functionalities of Cumulocity IoT.
Device Management
The Device Management application provides functionalities for managing and monitoring devices and enables you to control and troubleshoot devices remotely.
The following functionalities are available in Edge and described in detail in these sections:
| SECTION | CONTENT |
|---|---|
| Registering devices | How to register one or more devices manually and how to bulk-register devices in order to connect devices to your account. |
| Viewing all devices | What is displayed in the device list and how to sort devices by filtering devices. |
| Grouping devices | Why and how to group devices into top-level groups, subgroups and smart groups. |
| Viewing device details | Detailed description of the various kind of information available for various types of devices. |
| Monitoring and controlling devices | How to monitor the connection quality and availability status of devices, how to handle alarms from devices, how to remote control and how to troubleshoot devices. |
| Managing device services | How to monitor the data that your devices send about the services they are running. See detailed information about measurements, events and alarms sent for every service. |
| Managing device types | How to process data from various device types by using device protocols. |
| Managing device data | How to retrieve and manage firmware and software for devices; how to retrieve configuration data and store and manage it in a configuration repository as configuration snapshots. |
| SmartREST templates | How to work with SmartREST templates, a collection of request and response templates used to convert CSV data and Cumulocity IoT REST API calls. |
| Working with simulators | Create a simulator with the same level of functionality as connected hardware devices and simulate messages (measurements, alarms, events and inventory) that the device sends to the Cumulocity IoT platform with series of instructions that the simulator executes one after the other. |
| Connectivity | How to set up your Jasper Control Center account, configure the connectivity for the SIM provider in your Cumulocity IoT tenant, link SIMs and mobile devices, and checking connectivity. |
Cockpit
The Cockpit application provides you with options to manage and monitor Internet of Things (IoT) assets and data from a business perspective.
The following functionalities are available in Edge and described in detail in these sections:
| Section | Content |
|---|---|
| Managing assets | Organize assets in hierarchies by creating groups and assigning devices. |
| Data Explorer | Interactively explore, compare and visualize IoT data. Describes how to access and use the data explorer, add data points to the data explorer, customize data point properties, modify the visualization, store the data explorer as widget, and export the data. |
| Working with dashboards | Create your own analytics and monitor pages by adding and arranging widgets. Share dashboards among all devices of the same type. |
| Working with reports | Handle reports based on dashboard layouts, create reports for exporting data in CSV or excel format and schedule the export. |
| Using widgets in dashboards and reports | Widgets can display maps, images, graphs, tables and other graphic representations of data. Add a widget to a dashboard or a report, modify widgets, and add assets to a new or existing widget. |
| Widgets collection | Use various types of widgets from the Widgets collection that comes with Edge and configure them according your needs. |
| Managing exports | Export data to either CSV or Excel files. Add and schedule an export to a CSV or XLSX file to any point in time. |
| Data point library | Manage default settings (“profiles”) of your devices and apply them automatically using the Data point library. |
| Smart Rules | Create and manage business rules to work on incoming data in realtime and to perform actions based on this data. |
| Smart Rules collection | Use pre-defined global Smart Rules to configure rules for geofencing, thresholds or alarm escalation and notifications (SMS/email). Describes each smart rule and its configurable parameters in detail. |
| Configuring Cockpit applications | Configure custom Cockpit applications according to your individual needs. |
Administration
The Administration application enables account administrators to manage their users, roles, tenants and applications and lets them configure a number of settings for their account.
The following functionalities are available in Edge and described in detail in these sections:
| SECTION | CONTENT |
|---|---|
| Configuring Edge | Providing information on Edge specific configuration options. |
| Home screen | Providing information on your capacity usage and subscribed applications. |
| Managing users | How to add users, edit, disable or delete them. |
| Managing permissions | How to create and edit global roles and inventory roles, how to assign them to users, and how to grant application access. |
| Managing applications | How to manage and configure own applications in your Edge account. |
| Audit logs | How to view and filter audit logs that show security-relevant operations that have been processed by a user. See the different audit log types for more information. |
| Alarm mapping | Change the severity and text of alarms to adapt them to your business priorities. |
| Managing data | How to manage and configure retention rules for your data and how to manage stored files in the file repository. |
| Changing settings | How to change account settings like application settings, manage the properties library, enable SMS provider features like user notifications and two-factor authentication, and manage credentials for different providers. |